<!DOCTYPE html><html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    <title>Yoshimi User Manual ~ Oscillator Waveform</title>
    <link rel="stylesheet" type="text/css" href="../files/style.css">
  </head>
  <body>
    <nav class="navbar">
      <a href="../index.html">Index</a>
    </nav>
    <h2 style="text-align: center">Add/Pad Waveforms</h2>
    <img src="images/wave.png" alt="Waveform window" class="image">
    <p>
    This waveform editor is used for both AddSynth and PadSynth. There are quite a lot of controls that are highly specialised. Unfortunately, it is difficult to describe their operation without deep understanding of the mathematics involved.
    </p>
    <p>
    At the top there are a pair of graphic views. On the left is the complete oscillator with all filters and harmonic effects applied, and on the right the basic wave it is derived from.
    <br><br>
    The narrow images at the top are the harmonic distribution. Each vertical bar represents one actual harmonic. This is most obvious with a sinewave base.
    <br><br>
    The larger image below is a more familiar waveform as would be displayed on an oscilloscope.
    <br><br>
    Note: PadSynth doesn't have the <em>Phase or Harmonic Randomness</em> controls. Instead it has an <em>Apply</em> button, as the wavetable has to be rebuilt.
    <h3>Controls</h3>
    <div class="tab">
    The bank of sliders control 128 individual harmonics. The top row being amplitude, and the bottom row, relative phase.
    </br><br>
    <b>Mag. Type</b> (magnification type) This controls the amount of effect the harmonic sliders have on the waveform. Higher negative values giving less range but finer control.
    </br><br>
    <b>Phase Randomness</b> Provides a small random variation to the overall phase. Only really noticeable with multiple voices.
    </br><br>
    <b>Harmonic Randomness</b> Provides a small amplitude randomness to each harmonic.
    </br><br>
    <b>Base Function</b> Decides the basic waveshape. This is applied <em>per harmonic</em> so, for example, a square wave can become a complex stepped wave.
    </br><br>
    <b>Par.</b> (for base function). This modifies the actual mathematical formula. For example, with the control anti-clockwise the 'power' wave is logarithmic and in the other direction, is exponential.
    </br><br>
    <b>B.F.Mod</b> (base function modulator) This sets the type and enables the three modulation controls for the base function. These change the modulation formula in ways we don't currently understand.
    </br><br>
    <b>Use as base</b> Use the current wave shape as new base function, which can then again be mixed and modified with all controls.
    </br><br>
    <b>Wsh</b> (waveshape) Modifies the overall waveshape dependent on its parameter setting.
    </br><br>
    <b>Filter</b> (harmonics filter) Various filter types applied to the waveshape. The first parameter is the filter degree and the second one seems to be the Q factor.
    </br><br>
    <b>F</b> (first) If checked, this moves the filter ahead of the waveshaping (if it's used).
    </br><br>
    <b>Mod.</b> (harmonics modulator) This sets the type and enables the three modulation controls for the overall waveform. These change the modulation formula in ways we don't currently understand.
    </br><br>
    <b>Sp. adj.</b> (spectrum adjustment) This provides three different types of adjustment of the frequency spectrum of the overall waveform. The control varies the degree of change.
    </br><br>
    <b>Harmonic Shift</b> Changes the harmonic position in ways we don't currently understand.
    </br><br>
    <b>Shift 1st</b> Moves this function ahead of both Waveshaping and Filtering.
    </br><br>
    <b>Adpt. Harm</b> (adaptive harmonics) Changes the positions and amplitudes of the harmonics. The best way to understand the relationship between the slider and two parameter knobs is to watch the oscillator spectrum display (top left) while adjusting them.
    </br><br>
    <b>Clear</b> Returns the main harmonics sliders to their default positions.
    </br><br>
    <b>Sine</b> Recast the current wave shape in terms of simple sine waves, producing almost the same final result by setting all the harmonics to suitable amplitudes and phases.
    </br><br>
    <b>C</b> / <b>P</b> You can copy the entire settings from this window to the clipboard or store/load them as preset; this allows to replicate and then further modify them within another voice or even to use settings from AddSynth in PadSynth.
    </div>
    </p>
    <p>
    <a href="../resonance/resonance.html">Next</a> (Resonance)
    <a href="../add/add.html" class="up">To AddSynth</a>
    <br>
    <a href="../pad/pad.html" class="up">To PadSynth</a>
    <br>
    </p>
  </body>
</html>
